ايجاد Help در برنامه های وب

استفاده کنندگان برنامه های کامپيوتری همواره نيازمند توصيه ها و راهنمائی لازم به منظور استفاده از پتانسيل های يک برنامه می باشند. ارائه توضيحات لازم در خصوص نحوه استفاده از يک برنامه کامپيوتری با استفاده از برنامه های کمکی که به Help معروف می باشند ، صورت می پذيرد. طراحی وپياده سازی Help در يک نرم افزار، امروزه خود به يک تخصص خاص تبديل شده است و قطعا" به عنوان يکی از پارامترهای مهم در زمان انتخاب يک نرم افزار، مطرح خواهد بود (حداقل از جانب End Users ) . طراحان و پياده کنندگان نرم افزار با آناليز دقيق مخاطبان و نوع نياز آنا ن ، اقدام به طراحی و پياده سازی برنامه های help نموده و آنان را به عنوان جزء لاينفک نرم افزار ، ارائه می نمايند . برنامه های وب نيز از اين قاعده مستثنی نبوده و از روش های متفاوتی بمنظور ارائه Help ، استفاده می نمايند . در اين مقاله ، قصد داريم به بررسی روش های متفاوت ارائه Help در برنامه های وب دات نت ، بپردازيم .
برنامه های وب ، به منظور ارائه Help از روش های متفاوتی نظير : ToolTip برای کنترل ها ، فرم های وب و يا صفحات HTML و يا فايل های HTML Help ترجمه شده ، استفاده می نمايند . در ادامه به بررسی هر يک از موارد فوق ، خواهيم پرداخت .

نمايش ToolTip

ToolTip ، يک پيام کوتاه تشريحی است که پس از استقرار موس بر روی يک کنترل توسط کاربر ، برای مدت زمان بسيار محدودی نمايش داده می شود . از اين نوع پيام ها در برنامه های نوشته شده تحت ويندور و به منظور ارائه اطلاعات مفيد دررابطه با دکمه های Toolbar و يا ساير کنترل های گرافيک، استفاده می گردد. در زمان استفاده از آيکون ها و يا لينک ها ، می توان از يک ToolTip که عملکرد آنان را برای کاربران تشريح می نمايد ، استفاده نمود.
اکثر کنترل های سرويس دهنده ، دارای يک خصلت ToolTip می باشند که می توان از آن به منظور مقداردهی پيام مورد نظر جهت نمايش ، استفاده کرد. در زمان اجراء ، ASP.NET ، خصلت ToolTip را بعنوان خصلت عنوان کنترل ، برای مرورگر ارسال که IE آن را بعنوان يک ToolTip نمايش خواهد داد.
کنترل های HTML ، دارای خصلتی با نام ToolTip نمی باشند . در چنين مواردی می توان ، خصلت title را مستقيما" استفاده نمود . تگ های HTML زير ، تفاوت موجود بين نحوه مقداردهی يک ToolTip برای يک کنترل سرويس دهنده و يک کنترل HTML را نشان می دهد .

Setting ToolTip :: A server Control

<asp:Image id="Image1" runat="server" ImageUrl="100Four.gif" ToolTip="سايت سخاروش"></asp:Image>

Setting  ToolTip:: An HTML Control

<IMG src="100Five.gif" title="سايت سخاروش">

تمامی کنترل ها دارای خصلت ToolTip و يا title نمی باشند. مثلا" کنترل های سرويس دهنده DropDownList و ListBox ، امکانات فوق را دارا نمی باشند .

نمايش Help به عنوان فرم های وب و يا HTML

ايجاد محتويات Help با استفاده از فرم های وب و يا صفحات HTML ، از ساده ترين رويکردهای موجود بمنظور ارائه توضيحات و اطلاعات کمکی در يک برنامه وب ، می باشد . فايل های Help را می توان در فولدر مربوط به محل استقرار پروژه ( فولدر محل استقرار برنامه وب ) و يا در يک فولدر زير مجموعه ، مستفر نمود. از hyperlink و يا ساير کنترل ها ، می توان بمنظور نمايش Help در مرورگر استفاده نمود . روش فوق ، مشابه عملياتی است که دررابطه با ساير صفحات انجام می شود. در اين رابطه يک تفاوت اساسی وجود دارد : نمايش Help در يک پنجره جديد و يا يک فريم جداگانه .
نمايش Help در يک پنجره جداگانه ، باعث نگهداری موقعيت کاربر در برنامه وب شده و امکان استفاده از Help و مقايسه توضيحات ارائه شده با عمليات و يا کار جاری را در اختيار کاربرقرار خواهد داد . به منظور نمايش Help در يک پنجره جداگانه ، می توان از متد open مربوط به شی window ( سمت سرويس گيرنده ) ، استفاده نمود . کد زير ، نحوه انجام اين عمليات را نشان می دهد :

 

Setting ToolTip :: A server Control

<a href="#" onclick="window.open('Help1.aspx','helpwin').focus()">  Help مشاهده  </a>

در کد فوق از رويداد onclick به منظور نمايش Help در يک پنجره جديد مرورگر استفاده شده است .اولين آرگومان متد open ، فايل Help را مشخص می نمايد ، دومين آرگومان نامگذاری پنجره جديد را انجام می دهد ( زمينه هدايت ساير Help های زير مجموعه به پنجره يکسانی فراهم خواهد شد). متد focus ، اطمينان لازم در خصوص نمايش پنجره Help در قسمت بالای برنامه وب را بوجود می آورد.
ساير Heperlink های مربوط به Help در يک برنامه وب می توانند با استفاده از روش فوق ، از اسکريپت ساده onclick به منظور نمايش عناوين متفاوت در پنجره يکسانی، استفاده نمايند . در صورتيکه ، برنامه وب موجود دارای چندين hyperlink در رابطه با نمايش help در يک فرم وب باشد ، می توان اسکريپت را در يک روتين مستقر نمود و آن را در زمان تحقق رويداد onclick ، فراخواند . کد زير نحوه انجام اين کار را نشان می دهد :

Place Script in a procedure

<HTML>       <HEAD>         <title> WebForm1 </title>     <script language="vbscript">          Sub ShowHelp(topicName)              Set HelpWindow = window.open(topicName ,"helpwin" , "left=600 , height = 300 , width = 200 " )              HelpWindow.focus          End Sub      </script>          </HEAD>           <body>             <h2 align="right"><FONT size="3" color="#000099">نمايشراهنمای برنامهدر يک پنجرهجديد</FONT></h2>             <A onclick=" showHelp('Help1.aspx') " href="#">نمايش راهنمایبرنامه</A><Br>             <A onclick=" showHelp('Help2.aspx') " href="#">نمايشتوضيحات ضروریبرنامه</A> </body> </HTML>

نمايش HTML Help

با استفاده از متد showHelp مربوط به شی window ، می توان فايل های HTML Help ، فايل های HTML معمولی و يا فرم های وب را توسط نمايش دهنده HTML Help ( فايل hh.exe ) ، نمايش داد. يک فايل HTML Help ، شامل فايل های عناوين نوشته شده به HTML بوده که به يک فايل فشرده و جداگانه تبديل شده اند . اين نوع فايل ها ، ويژگی های اضافه ای را در رابطه با Help ارائه می نمايند . متد showHelp ، عناوين را در نمايش دهنده HTML Help ، نمايش خواهد داد (بصورت پيش فرض در بالای صفحه مربوط به پنجره مرورگر برنامه وب ) . به منظور نمايش يک فرم وب و يا صفحه HTML با استفاده از showHelp ، نام فرم وب و يا صفحه HTML را می بايست بعنوان اولين آرگومان متد، مشخص نمود.

Show Help with HTML Help Viewer

<a href="#" onclick="window.showHelp('Help1.aspx')">مشاهده راهنما</a>

با استفاده از متد Showhelp ، می توان فايل های Help ترجمه شده را نيز مشاهده نمود . اين نوع فايل ها از صفحات HTML تشکيل شده که در نهايت به يک فايل ترجمه می گردند ( فايلی با انشعاب chm ) . برای ايجاد اين نوع از فايل ها می بايست از برنامه HTML Help Workshop استفاده گردد . به منظور نمايش يک فايل ترجمه شده ، می بايست نام آن بعنوان اولين آرگومان متد showHelp مشخص گردد .

Show a Compiled HTML Help File by showHelp method

<a href="#" onclick="window.showHelp('C:\\php_manual_en.chm')">PHP  مشاهده راهنمای</a>

HTML فوق ، فايل ترجمه شده ای با نام php_manual_en.chm را نمايش خواهد داد . فايل Help ترجمه شده ،می بايست Download و بر روی ماشين کاربر ذخيره گردد .

استفاده از فايل های Help ترجمه شده ، دارای مزايای زير است :

• کاهش اندازه : فايل های Help ترجمه شده ، عناوين را فشرده نموده و اندازه آنان بمراتب نسبت به مجموع ظرفيت يکايک عناوين ، کمتر می باشد .
• محتوی ، ايندکس و ابزارهای جستجو : برنامه HTML Help Workshop ، شامل ابزارهای لازم به منظور ايجاد ويژگی های فوق و افزودن آنان به Help می باشند .
• نمايش Embeded : کنترل اکتيوايکس HTML Help و اپلت جاوا ، امکان نمايش Help را بهمراه پنجره مرورگر فراهم می نمايند(در مقابل نمايش آنان در يک پنجره جداگانه )
• محلی سازی ساده : با توجه به اينکه HTML Help ، فايل های عناوين را به Context ID مپ می نمايد ، امکان استفاده از چندين فايل Help نوشته شده با زبان های متفاوت که جملگی از مجموعه يکسانی Context ID ، استفاده می نمايند، وجود خواهدداشت .
فايل های Help ترجمه شده ، دارای محدويت های خاص خود بوده که لازم است در زمان استفاده از اين نوع فايل ها ، به آنان توجه گردد :
• فايل منبع می بايست دارای فرمت HTML باشد . فرم های وب نمی توانند به فايل های chm. ، ترجمه گردند .
• تمامی فايل ترجمه شده می بايست بر روی ماشين کاربر ، مستقر( DownLoad ) گردند . در صورتيکه دارای يک فايل Help بزرگ بوده و کاربر با استفاده از يک مودم معمولی! به برنامه وب متصل می گردد، مدت زمان زيادی صرف استقرار فايل بر روی ماشين کاربر خواهد شد.